home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / rzsz1291.zip / RZ.DOC < prev    next >
Text File  |  1991-10-30  |  11KB  |  265 lines
  1.  
  2.  
  3.  
  4.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       rx, rc, rb, rz - Receive Files and Commands with X/Y/ZMODEM
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       rrrrzzzz [-    ttttvvvv]
  13.       rrrrbbbb [-    ttttvvvv]
  14.       rrrrcccc [-    ttttvvvv] _f_i_l_e
  15.       rrrrxxxx [-    ttttvvvv] _f_i_l_e
  16.       ggggzzzz _f_i_l_e ...
  17.       [----][vvvv]rrrrzzzzCCCCOOOOMMMMMMMMAAAANNNNDDDD
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.       This program uses error correcting protocols to receive
  21.       files    over a dial-in serial port from    a variety of programs
  22.       running under    PC-DOS,    CP/M, Unix, and    other operating
  23.       systems.  It is invoked from a shell prompt manually,    or
  24.       automatically    as a result of an "sz file ..."    command    given
  25.       to the calling program.
  26.  
  27.       This is a copyrighted    shareware program.  Commercial use of
  28.       this program is subject to licensing conditions detailed in
  29.       the rz.c source code.     "Commercial Use" includes use of this
  30.       program to receive files from    commercial and/or shareware
  31.       programs not published by Omen Technology INC.
  32.  
  33.       This program is not designed to be called from _c_u(_1),
  34.       _t_i_p(_1), or other communications programs.  Unix flavors of
  35.       Omen Technology's Professional-YAM communications software
  36.       are available    for dial-out applications.  Unix
  37.       Professional-YAM supports dial-out applications with
  38.       telephone directory, a powerful script language with learn
  39.       function, high quality multiple protocol support, and    UUCP
  40.       port arbitration.
  41.  
  42.  
  43.       RRRRzzzz (Receive ZMODEM) receives one or more files with the
  44.       ZMODEM protocol.  Pathnames are supplied by the sending
  45.       program, and directories are made if necessary (and
  46.       possible).  Normally,    the "rz" command is automatically
  47.       issued by the    calling    ZMODEM program,    but defective ZMODEM
  48.       implementations may require starting _r_z manually.
  49.  
  50.       RRRRbbbb receives file(s) with YMODEM, accepting either standard
  51.       128 byte sectors or 1024 byte    sectors    (YAM sb    ----kkkk option).
  52.       The user should determine when the 1024 byte block length
  53.       actually improves throughput.
  54.  
  55.       If True YMODEM (Omen Technology trademark) file information
  56.       (file    length,    etc.) is received, the file length controls
  57.       the number of    bytes written to the output dataset, and the
  58.       modify time and file mode (iff non zero) are set
  59.       accordingly.
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/30/91)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       If True YMODEM file information is not received, slashes in
  75.       the pathname are changed to underscore, and any trailing
  76.       period in the    pathname is eliminated.     This conversion is
  77.       useful for files received from CP/M and other    historical
  78.       systems.
  79.  
  80.       RRRRcccc receives a    single _f_i_l_e with XMODEM-CRC or XMODEM-1k-CRC
  81.       protocol.  The user should determine when the    1024 byte
  82.       block    length actually    improves throughput without causing
  83.       problems.  The user must supply the file name    to both
  84.       sending and receiving    programs.  Up to 1023 garbage
  85.       characters may be added to the received file.
  86.  
  87.       RRRRxxxx receives a    single _f_i_l_e with XMODEM    or XMODEM-1k protocol.
  88.       The user should determine when the 1024 byte block length
  89.       actually improves throughput without causing problems.  The
  90.       user must supply the file name to both sending and receiving
  91.       programs.  Up    to 1023    garbage    characters may be added    to the
  92.       received file.
  93.  
  94.       GGGGzzzz is    a shell    script which calls _s_z to command Pro-YAM or
  95.       ZCOMM    to transmit the    specified files.  Pathnames used with
  96.       _g_z must be escaped if    they have special significance to the
  97.       Unix shell.
  98.       EXAMPLE: gz "-a C:*.c    D:*.h"
  99.  
  100.       RRRRzzzz may be invoked as rrrrzzzzCCCCOOOOMMMMMMMMAAAANNNNDDDD (with an optional leading -
  101.       as generated by login(1)).  For each received    file, _r_z will
  102.       pipe the file    to ``COMMAND filename''    where filename is the
  103.       name of the transmitted file with the    file contents as
  104.       standard input.
  105.  
  106.       Each file transfer is    acknowledged when COMMAND exits    with 0
  107.       status.  A non zero exit status terminates transfers.
  108.  
  109.       A typical use    for this form is _r_z_r_m_a_i_l which calls rmail(1)
  110.       to post mail to the user specified by    the transmitted    file
  111.       name.     For example, sending the file "caf" from a PC-DOS
  112.       system to _r_z_r_m_a_i_l on a Unix system would result in the
  113.       contents of the DOS file "caf" being mailed to user "caf".
  114.  
  115.       On some Unix systems,    the login directory must contain a
  116.       link to COMMAND as login sets    SHELL=rsh which    disallows
  117.       absolute pathnames.  If invoked with a leading ``v'',    _r_z
  118.       will report progress to /tmp/rzlog.  The following entry
  119.       works    for Unix SYS III/V:
  120.              rzrmail::5:1::/bin:/usr/local/rzrmail
  121.       If the SHELL environment variable includes _r_s_h or _r_k_s_h
  122.       (restricted shell), _r_z will not accept absolute pathnames or
  123.       references to    a parent directory, will not modify an
  124.       existing file, and removes any files received    in error.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/30/91)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.       The meanings of the available    options    are:
  141.  
  142.       tttt ttttiiiimmmm
  143.            Change timeout to _t_i_m tenths of seconds.
  144.       vvvv    Verbose causes a    list of    file names to be appended to
  145.            /tmp/rzlog .  More v's generate more detailed debugging
  146.            output.
  147.       (Pro-YAM command)
  148.       <_A_L_T-_2>
  149.       Pro-YAM Command: _s_z *._h *._c
  150.       (This    automatically invokes _r_z on the    connected system.)
  151.  
  152.  
  153.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  154.       Exit status is as follows: 0 for successful transfers.  1 if
  155.       unrecoverable    errors are detected.  2    if syntax errors or
  156.       file access problems are detected.  3    if the program was
  157.       terminated by    a caught interrupt.
  158.  
  159.  
  160.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  161.       Professional-YAM, ZCOMM, DSZ,    crc(omen), sz(omen),
  162.       usq(omen), undos(omen)
  163.  
  164.       Compile time options required    for various operating systems
  165.       are described    in the source file.
  166.  
  167.      NNNNOOOOTTTTEEEESSSS
  168.       ZMODEM's support of XOFF/XON flow control allows proper
  169.       operation in many environments that do not support XMODEM
  170.       uploads.  Unfortunately, not all Unix    versions support input
  171.       flow control.     The TTY input buffering on some systems may
  172.       not adequately buffer    long blocks or streaming input at high
  173.       speed.  You should suspect this problem when you can't send
  174.       data to the Unix system at high speeds using ZMODEM,
  175.       YMODEM-1k or XMODEM-1k, but YMODEM with 128 byte blocks
  176.       works    properly.
  177.  
  178.       The DSZ or Pro-YAM zzzzmmmmooooddddeeeemmmm llll numeric parameter    may be set to
  179.       a value between 64 and 1024 to limit the burst length
  180.       ("zmodem pl128").  Although this compromises ZMODEM's
  181.       throughput, ZMODEM's superior    reliability remains intact.
  182.  
  183.       If a program that does not properly implement    the specified
  184.       file transfer    protocol causes    _r_z to "hang" the port after a
  185.       failed transfer, either wait for _r_z to time out or keyboard
  186.       a dozen Ctrl-X characters.  Every reported instance of this
  187.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  188.       other    program    with a correct implementation of the specified
  189.       protocol.
  190.  
  191.       Many programs    claiming to support YMODEM only    support    XMODEM
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 10/30/91)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.       with 1k blocks, and they often don't get that    quite right.
  207.  
  208.       In the case of a few poorly designed microcomputers, sending
  209.       serial data to a tty port at sustained high speeds has been
  210.       known    to cause lockups, system halts,    kernel panics, and
  211.       occasional antisocial    behaviour.  This problem is not    unique
  212.       to _r_z; CRT terminals with block mode transmission and    line
  213.       noise    have the same effect.  When experimenting with high
  214.       speed    input to a system, consider rebooting the system if
  215.       the file transfers are not successful, especially if the
  216.       personality of the system appears altered.
  217.  
  218.       The Unix "ulimit" parameter must be set high enough to
  219.       permit large file transfers to Unix.
  220.  
  221.       Telebit modems must not be set to "spoof" UUCP, XMODEM, or
  222.       KERMIT.  Setting one of these    spoofing modes interferes with
  223.       other    protoocls.
  224.  
  225.       32 bit CRC code courtesy Gary    S. Brown.  Directory creation
  226.       code from John Gilmore's PD TAR program.
  227.  
  228.      BBBBUUUUGGGGSSSS
  229.       This version of _r_z does not support some ZMODEM features.
  230.       Unix flavors of Professional-YAM may be linked to "rz" to
  231.       support these    features.
  232.  
  233.       The ASCII option's CR/LF to NL translation merely deletes
  234.       CR's;    undos(omen) performs a more intelligent    translation.
  235.  
  236.      ZZZZMMMMOOOODDDDEEEEMMMM CCCCAAAAPPPPAAAABBBBIIIILLLLIIIITTTTIIIIEEEESSSS
  237.       _R_z supports ZMODEM command execution (zcommand), incoming
  238.       ZMODEM binary    (-b), ASCII (-a), newer(-n), newer+longer(-N),
  239.       protect (-p),    Crash Recovery(-r), clobber (-y),
  240.       match+clobber    (-Y), compression(-Z), and append (-+)
  241.       requests.  Other options sent    by the sender are ignored.
  242.       The default is protect (-p) and binary (-b).
  243.  
  244.       Unix Professional-YAM    provides higher    performance and    other
  245.       features not supported by _r_z.    Please contact Omen Technology
  246.       Inc for product information.
  247.  
  248.       Omen Technology INC
  249.       Post Office Box 4681
  250.       Portland OR 97208
  251.       503-621-3406
  252.  
  253.  
  254.      FFFFIIIILLLLEEEESSSS
  255.       rz.c,    crctab.c, rbsb.c, zm.c,    zmr.c, zmodem.h, rz.1
  256.  
  257.       /tmp/rzlog stores debugging output generated with -vv    option
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 10/30/91)
  262.  
  263.  
  264.  
  265.